home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cdbox211.zip / CD-BOX.DOC < prev    next >
Text File  |  1992-09-19  |  73KB  |  1,508 lines
  1. ╒════════════════════════════════════════════════════════════════════════════╕
  2. │              Welcome to CD-Box v2.11 - (C) Jeffrey Belt, 1992              │
  3. ├────────────────────────────────────────────────────────────────────────────┤
  4. │ .CMF/.MOD/.MUS/.ROL/.VOC player & shell for AdLib/SoundBlaster - Shareware │
  5. ╘════════════════════════════════════════════════════════════════════════════╛
  6. Quick start:
  7.  
  8.   0. You must have a VGA display (color), a mouse, and an Adlib or
  9.        SoundBlaster card - a hard disk is also highly recommended.
  10.  
  11.   1. Create a directory in which you put all CD-BOX.* files, and every music
  12.        file (.CMF, .MOD, .MUS, .ROL and .VOC) you can find, either as is or
  13.        stored in .ZIP files. Also make sure SBFMDRV.COM, SOUND.COM, PLAY.EXE,
  14.        SPUTROL.COM, VPLAY.EXE and PKUNZIP.EXE (if you don't have them all, do
  15.        the best you can) are on the PATH (or the SOUND environment variable)
  16.        somewhere.
  17.  
  18.   2. Type CD-BOX and press Enter (the first time CD-Box is run, the directory
  19.        scan may take a looooong time, especially if you have many songs - be
  20.        patient, it will go much faster the second time).
  21.  
  22.   3. Fool around and see what CD-Box can do.
  23.  
  24. If you have trouble, see part IV, troubleshooting.
  25.  
  26. If you have players others than those listed above, check out CD-BOX.CFG.
  27.  
  28. If you use CD-Box, you have to register it; see part VII (at the end).
  29.  
  30. If you want more details:
  31.  
  32.   * Type CD-BOX/? at the DOS prompt
  33.  
  34.   * Read the rest of this document!
  35.  
  36. ══════════════════════════════════════════════════════════════════════════════
  37. Acknowledgments
  38.  
  39.    AdLib Music Synthetizer Card is a registered trademark of AdLib, Inc. Also,
  40.      SOUND.COM is copyrighted by AdLib, Inc.
  41.  
  42.    SoundBlaster is a registered trademark of Creative Labs, Inc. Also,
  43.      SBFMDRV.COM and VPLAY.EXE are copyrighted by Creative Labs, Inc.
  44.  
  45.    PKUNZIP is copyrighted by PKWARE, Inc.
  46.  
  47. CD-Box supports by default the following drivers/players (you are free to
  48.   change this by editing the CD-BOX.CFG file):
  49.  
  50.    SBFMDRV.COM and VPLAY.EXE from Creative Labs, Inc. They come with the
  51.        SoundBlaster.
  52.  
  53.    SOUND.COM from Adlib, Inc. It comes with the AdLib Music Synthetizer Card
  54.        (which I bought before switching to a SoundBlaster, but I have no
  55.        regrets...). There also is a SB-SOUND.COM from Creative Labs, Inc;
  56.        rename it to SOUND.COM for SPUTROL to work (or load it before running
  57.        CD-Box).
  58.  
  59.    SPUTROL.COM from the Sputter package, available from VersaWare (Adrienne
  60.        Cousins) (that one is Shareware). Last thing I know it was on
  61.        nic.funet.fi, and snake.mcs.kent.edu. You might try replacing SPUTROL
  62.        with PLAYROL from Tracy Harton, provided it can run in quiet mode (the
  63.        old version I have doesn't)... see CD-BOX.CFG for details.
  64.  
  65.    PLAY.EXE which is completely anonymous (I downloaded it from a FTP server
  66.        somewhere which IT got from THE TASTE/MG BBS, 718-252-4529, as
  67.        ADLIBMUS.ZIP, with no accompanying documentation, no author name, no
  68.        nothing). If you know where to find it, tell me!
  69.  
  70. Exactly which program does what in detailed at the beginning of part II.
  71.  
  72. ══════════════════════════════════════════════════════════════════════════════
  73.  
  74.                            TABLE OF CONTENTS
  75.  
  76. ══════════════════════════════════════════════════════════════════════════════
  77.  
  78.            Part I:   How to use CD-Box
  79.            Part II:  General questions & answers about CD-Box
  80.                        (including exactly which drivers/players are needed,
  81.                         some FTP addresses, how CD-Box interacts with them...)
  82.            Part III: Keyboard support
  83.            Part IV:  Trouble-shooting
  84.            Part V:   Version history, how you can help, and thanks
  85.            Part VI:  License & absence of warranty
  86.            Part VII: Registering CD-Box
  87.  
  88. ══════════════════════════════════════════════════════════════════════════════
  89. Compatibility
  90.  
  91. CD-BOX v2.11 IS FULLY COMPATIBLE WITH ALL VERSIONS OF CD-BOX ABOVE 2.00. You
  92.   can overwrite the old CD-Box files with the new ones, provided the old
  93.   version is v2.00, v2.01, v2.02 or v2.10.  If you're one of those who still
  94.   have CD-Box v1.61 or below, CD-Box will ask you to delete the SONGS.DAT
  95.   file.
  96.  
  97. ══════════════════════════════════════════════════════════════════════════════
  98. Change of status: CD-Box (starting with this version) is shareware.
  99.  
  100. New features in CD-Box v2.11:
  101.  
  102. - keyboard support (mouse is recommended but no longer required)
  103. - for .MOD files: volume control, skip backward/forward within the song, and
  104.     "level" bars
  105.  
  106. Small improvements:
  107.  
  108. - wildcards accepted in /R and /V
  109. - wildcards accepted in /V (done)
  110. - /V can be ESCaped
  111. - Rem. and Total retain their settings throughout a whole session
  112. - Unselect works in Files mode
  113. - MODDevice= parameter added in CD-BOX.CFG
  114.  
  115. ══════════════════════════════════════════════════════════════════════════════
  116.  
  117.                               PART I: CD-BOX
  118.  
  119. ══════════════════════════════════════════════════════════════════════════════
  120. *** What does CD-Box do?
  121. ──────────────────────────────────────────────────────────────────────────────
  122.  
  123. CD-Box is, stated simply, a program which plays back music files on the AdLib
  124.   Music Synthetizer Card and the SoundBlaster card. However, it is also very
  125.   pretty and fun to use - it runs in 256 colors and can use your mouse.
  126.  
  127. CD-Box's main features:
  128.  
  129.   - A pretty interface and fun animation - CDs pop up and down and start and
  130.       stop spinning, pages scroll... including random events I'll let you
  131.       discover!
  132.  
  133.   - Support for .CMF, .MOD, .MUS, .ROL and .VOC music/sound files (.CMF, .MOD
  134.       and .VOC files work with SoundBlaster only). These files can also be
  135.       stored in .ZIP files to save disk space - CD-Box will find them and play
  136.       them from the archive (using a RAM drive if you want). .MOD also have
  137.       volume control and skipping backward and forward within the song.
  138.  
  139.   - CD-Box allows you to easily program a selection of songs; it waits for you
  140.       to select ALL the songs before starting to play the first one.
  141.  
  142.   - Instead of selecting songs, you can tell CD-Box how long you want the
  143.       playback to last, and CD-Box will automatically select songs for you.
  144.       You can even do that from the DOS command line (or a batch file), and
  145.       CD-Box will play the songs, then exit right back to DOS.
  146.  
  147.   - CD-Box makes it easy to choose files in which to pick songs (using Files
  148.       mode, one of the latest additions) - so if you ZIPped your songs by
  149.       category, you can tell CD-Box which categories to use!
  150.  
  151.   - No data file to keep to date; bank filenames and song titles can be
  152.       modified directly from CD-Box, which will save your changes to disk.
  153.       CD-Box also knows the titles and lengths of numerous songs, and when it
  154.       encounters unknown songs, can sometimes (it depends on the format)
  155.       extract data from the files on disk.
  156.  
  157.   - CD-Box is able to examine the SOUND environnment variable and of loading
  158.       drivers and player programs from there if necessary (as any good
  159.       SoundBlaster software should do).
  160.  
  161.  
  162. ──────────────────────────────────────────────────────────────────────────────
  163. And now, the fun part: how CD-Box works
  164.  
  165. Note that the explanations below, as with most of this documentation, supposes 
  166.   you have a mouse and CD-Box is able to use it. If you use the keyboard, see 
  167.   part III for mouse equivalents.
  168.  
  169. You run it by typing CD-BOX at the DOS prompt. Obvious, really. You are then
  170.   in...
  171.  
  172. ══════════════════════════════════════════════════════════════════════════════
  173. *** SELECT MODE: to select and play songs
  174. ──────────────────────────────────────────────────────────────────────────────
  175.  
  176.   - Move between the pages by clicking on the "Rewind" and "Forward" buttons.
  177.       Pressing the RIGHT mouse button on "Rewind" and "Forward" brings you to
  178.       the first and last page, respectively.
  179.  
  180.   - Select one or more songs to play by clicking on the small button next to
  181.       the songs' names; they will be played back in the order you selected
  182.       them. The digital display changes color and displays the total length
  183.       time of your selection.
  184.  
  185.   - Click on "Loop" if you want your selection to be played over and over
  186.       again.
  187.  
  188.   - Click on "Play" to play the songs - you'll be in Play mode (see below).
  189.  
  190.   - Clicking on "Random" brings you into Random mode. You can then select the 
  191.       total playing time you wish, by clicking on the "Rewind" and "Forward" 
  192.       buttons; pressing the RIGHT mouse button brings up the minimum and 
  193.       maximum playing time, respectively (you can also use PgUp/PgDn to 
  194.       quickly increase and decrease playing time). Once the desired time is
  195.       displayed on the digital display, click on "Play". CD-Box will randomly
  196.       select additional songs until the desired time is reached, then play the
  197.       songs.
  198.  
  199. ******************************************************************************
  200.  NOTE: Certain songs may be of unknown length (they were not known to CD-Box
  201.  and they have never been played yet). When such a song is selected, CD-Box
  202.  supposes the length is zero. Therefore, if you use the "Random" button and
  203.  suchs songs are chosen, the actual playing time may be far longer than the
  204.  playing time you entered; so try not to use "Random" before you have played
  205.  all the songs (if you do, Esc still works). Of course a way to play all the
  206.  songs is to use Random mode and choose the maximum playing time.
  207. ******************************************************************************
  208.  
  209.   - Clicking on "Random" while in Random mode, exits Random mode.
  210.  
  211.   - Clicking on the wide "Unselect" button will unselect ALL the songs.
  212.  
  213.   - Finally, click on "Eject" to quit.
  214.  
  215.  
  216. ══════════════════════════════════════════════════════════════════════════════
  217. *** PLAY MODE: while songs are being played back
  218. ──────────────────────────────────────────────────────────────────────────────
  219.  
  220.   - Each song is played in turn, and then de-selected, unless "Loop" is in the
  221.       down position, in which case they are reselected to be played again
  222.       later.
  223.  
  224.   - Pressing Esc while a song is playing interrupts the current song, and
  225.       CD-Box starts looking for the next one. If you press Esc between songs,
  226.       playback stops entirely (songs not yet played remain selected). You've
  227.       got to press Esc twice quite fast to stop the playback in fast mode.
  228.  
  229. If the buttons have flipped to reveal another set of buttons, you also have
  230.   access to the real-time clock and the following functions (.CMF and .MOD
  231.   files only (for now!)):
  232.  
  233.   - Stop: stops playback entirely (same as pressing Esc between songs).
  234.  
  235.   - Skip: interrupts the current song (same as pressing Esc while playing).
  236.  
  237.   - Pause/Resume: toggle it once to pause the music, and toggle it again to
  238.       have it pick up where it left off.
  239.  
  240.   - Rem.: if pressed, the digital display shows the time left until the song
  241.       or the total selection ends (see next button), as far as CD-Box can
  242.       tell; if not, the digital display shows the time elapsed since the
  243.       beginning of the song or the total selection.
  244.  
  245.   - Total: if pressed, the digital display shows the time elapsed or left (see
  246.       previous button) for the current song; if not, it shows the time elapsed
  247.       or left for the whole selection. Got it?
  248.  
  249.   REGISTERED VERSION ONLY and .MOD files only:
  250.  
  251.   - Volume control: press a button in the colored row to select the volume.
  252.       Volumes changes are not instantaneous (some .MOD files sometimes sound
  253.       weird while the volume is being changed). The higher the volume, the
  254.       better the quality.
  255.  
  256.   - Skipping backward/forward within the song: press the button to the left of
  257.       the volume control or the one to the right. CD-Box will "skip" a little
  258.       of the song in either way. Trying to skip back the beginning of the song
  259.       will restart the song, and trying to skip past the end will stop it.
  260.  
  261. Play mode switches back to Select mode when playback ends (whether you
  262.   interrupted it or not).
  263.  
  264.  
  265. ══════════════════════════════════════════════════════════════════════════════
  266. *** MODIFY MODE: used to modify bank files and song titles
  267. ──────────────────────────────────────────────────────────────────────────────
  268.  
  269. Click on the wide "Modify" button to enter Modify mode. All the songs will be
  270.   unselected, and the row of buttons will flip and reveal another set of
  271.   buttons. "Rewind" and "Forward" work the same.
  272.  
  273.   - You can display the song titles, bank files or filename by clicking on one
  274.       of the three buttons at the right.
  275.  
  276.   - If you click on a small button next to a song, a dot cursor will appear
  277.       and you will be able to modify whatever is displayed, using the keyboard
  278.       (Backspace, Enter and Escape do the ovious things). Any changes you type
  279.       in will be automatically saved to disk once you exit CD-Box.
  280.  
  281.  
  282. ══════════════════════════════════════════════════════════════════════════════
  283. *** GOTO MODE: used to jump to a specific title (or filename, see Files mode)
  284. ──────────────────────────────────────────────────────────────────────────────
  285.  
  286. Click on "Goto...", and an alphabetic set of buttons will appear. From there,
  287.   simply choose a letter, and CD-Box will "Rewind" or "Forward" directly to
  288.   the page containing the first song starting by the letter you selected, and
  289.   flash that song briefly.  If no such song exists, CD-Box tries with the next
  290.   letter, and the next, and may finally give up by giving an error message.
  291.  
  292. When you exit Goto mode, either automatically, or by clicking on Goto a second
  293.   time, you will be brought back to the same mode you were in before entering
  294.   Goto mode. Goto is accessible from all modes.
  295.  
  296.  
  297. ══════════════════════════════════════════════════════════════════════════════
  298. *** FILES MODE: to tag/untag files for scanning
  299. ──────────────────────────────────────────────────────────────────────────────
  300.  
  301. Click on "Files...", and CD-Box will save any changes you have made (bank
  302.   files, song titles, whatever), and promptly forget all the songs in memory.
  303.   Files names will then be displayed instead of song titles. These files are
  304.   NOT the song files themselves, but rather the files CD-Box scanned to get
  305.   the songs in memory - the difference is that .ZIP files will be displayed as
  306.   such, instead of having a separate entry for each file in the .ZIP file (as
  307.   is the case in Modify mode when the "File" button is pressed).
  308.  
  309. All files are selected by default. You can browse through the list using
  310.   "Rewind" and "Forward" as usual, and "Goto..." a specific filename... and
  311.   when you click on "Rescan", CD-Box will rescan ONLY the files left selected.
  312.   Thus, if you left all the files selected, CD-Box will reload all the songs
  313.   and nothing will be changed. If you unselected them all, CD-Box will load no
  314.   songs.
  315.  
  316. This serves as a "filter" for the songs displayed in CD-Box, and used by (for
  317.   instance) Random mode. If your songs are ZIPped by category, switching to
  318.   Files mode and choosing only certain categories will tell CD-Box to display
  319.   and use only the songs in these categories. If you don't use .ZIP files at
  320.   all, then probably Files mode will not be of much use to you.
  321.  
  322. Note that the files displayed are not all the files in the directory, but
  323.   rather those that contain songs. Also, if you specified /L at startup, any
  324.   unplayable files in the directory will not be displayed. And, if you
  325.   specified file specifications at startup (for instance, CD-BOX *.MOD
  326.   Z*.ZIP), only the files matching these specifications will be displayed.  
  327.   All this is cumulative, of course. The command line serves as a first
  328.   filter, and Files mode then enables you to choose the filtered files by
  329.   hand.
  330.  
  331. Files mode much simpler to use than to describe, believe me... try it!
  332.  
  333.  
  334. ══════════════════════════════════════════════════════════════════════════════
  335. *** DEBUG MODE: to have a quick look at CD-Box's startup
  336. ──────────────────────────────────────────────────────────────────────────────
  337.  
  338. This is not really a mode in the sense of those described above, but is a
  339.   command-line parameter important enough to be included here. Typing CD-BOX/D
  340.   at the DOS prompt:
  341.  
  342.   * returns the registration number (if any!)
  343. ;
  344.   * checks the CD-BOX.CFG file for errors, reporting any, so that you can
  345.       correct them;
  346.  
  347.   * displays, for each driver and player, whether it was found or not;
  348.  
  349.   * scans the directory for songs, displaying each song name in turn, so that
  350.       you may find which song exactly makes CD-Box crash (if any).
  351.  
  352.  
  353. ══════════════════════════════════════════════════════════════════════════════
  354.  
  355.                         PART II: GENERAL QUESTIONS
  356.  
  357. ══════════════════════════════════════════════════════════════════════════════
  358. *** How does CD-Box play songs?
  359. ──────────────────────────────────────────────────────────────────────────────
  360.  
  361. It depends on the format. For each format, CD-Box follows these rules:
  362.  
  363.   * If there is a section about this format in CD-BOX.CFG ([<format>]), then
  364.       CD-Box will provide external support, and:
  365.  
  366.       * If there is a "Dual=yes" statement in the section, and CD-Box has 
  367.           internal support for this format (.CMF or .MOD), then CD-Box will 
  368.           first try playing such songs using its own routines, and, if this 
  369.           fails (error while loading or whatever), use the external player.
  370.  
  371.       * If there is no such statement in the section, then CD-Box will ALWAYS 
  372.           use this player to play the song, using the parameters given in
  373.           CD-BOX.CFG.
  374.  
  375.   * If there is no section on this format in CD-BOX.CFG, then CD-Box will use 
  376.       its internal routines to play the song, if any. CD-Box currently
  377.       provides internal support for .CMF and .MOD files.
  378.  
  379.   * In all other cases, CD-Box will NOT play songs of this format (the
  380.       corresponding pilot light above the song names is grayed).
  381.  
  382. Usually you'll want CD-Box to play songs by itself; it's by far the easiest
  383.   way, there's no player to install, and you can pause, resume and stop the
  384.   song using the mouse. However, you would use an external player if:
  385.  
  386.   * CD-Box provides no internal support for the corresponding format
  387.  
  388.   * Or the sound given by the player you have is better than that of CD-Box, 
  389.       or the player supports a wider range of capabilities (what if you've got 
  390.       the AdLib and have a player which can play .CMF on your card?), so you
  391.       might want to override CD-Box's routines for that format.
  392.  
  393. Note that even if CD-Box does have internal support for some formats, it may
  394.   still need the corresponding driver. See right below for details.
  395.  
  396.  
  397. ══════════════════════════════════════════════════════════════════════════════
  398. *** Exactly what programs do I need for each song format?
  399. ──────────────────────────────────────────────────────────────────────────────
  400.  
  401. In addition to CD-BOX.EXE (the program), CD-BOX.RSR (the resource file), and 
  402.   CD-BOX.CFG (the configuration file), you need songs to play, and a player 
  403.   program in most cases. The default (you can change that, see CD-BOX.CFG for 
  404.   details) music playback programs supported by CD-Box and the corresponding 
  405.   song formats are:
  406.  
  407.     ┌─────────────────────────────┐
  408.     │ Creative Music Files (.CMF) │ SoundBlaster only
  409.     └─────────────────────────────┘
  410.         You need the sound driver SBFMDRV.COM from Creative Labs, Inc, and it
  411.         has to be loaded in memory before CD-Box is run. (You can remove it by
  412.         typing SBFMDRV /U once you exit CD-Box). No other program is
  413.         necessary, .CMF routines are programmed directly into CD-Box.
  414.  
  415.     ┌────────────────────────┐
  416.     │ Amiga MOD files (.MOD) │ SoundBlaster only
  417.     └────────────────────────┘
  418.         You need nothing except lots of memory; CD-Box is linked to internal
  419.         .MOD playing routines.
  420.  
  421.     ┌────────────────────┐
  422.     │ Music files (.MUS) │ AdLib & SoundBlaster
  423.     └────────────────────┘
  424.         You need PLAY.EXE. Each .MUS file also needs a .SND bank file, so be
  425.         sure to put them in the directory too. (ex: AGNES.MUS and AGNES.SND,
  426.         MULL.MUS and MULL.SND...)
  427.  
  428.         Note: .MUS bank files (.SND files) are different from Macintosh raw
  429.         sound files (.SND extension also) - the former contain instrument data
  430.         and the latter a complete digitized sound. 
  431.  
  432.     ┌─────────────────────┐
  433.     │ ROLand files (.ROL) │ AdLib & SoundBlaster
  434.     └─────────────────────┘
  435.         You need SPUTROL.COM, and the sound driver SOUND.COM from AdLib, Inc;
  436.         but you don't have to load it before running CD-Box. SPUTROL will
  437.         itself load it if necessary, and unload it when done. .ROL files also
  438.         need at least one .BNK bank file, which usually is STANDARD.BNK.
  439.  
  440.         If you have SB-SOUND.COM from Creative Labs, Inc, rename it to
  441.         SOUND.COM so that SPUTROL can detect it (unless you use another player
  442.         which properly detects SB-SOUND...)
  443.  
  444.         Since many of you asked... ROL2CMF will convert .ROL to .CMF so you
  445.         can use CD-Box's internal routines instead of SPUTROL. ROL2CMF is
  446.         widely available on FTP servers, such as saffron.inset.com, directory
  447.         pub/sound/players.
  448.  
  449.     ┌─────────────────────────────────┐
  450.     │ SoundBlaster VOiCe files (.VOC) │ SoundBlaster only
  451.     └─────────────────────────────────┘
  452.         You need VPLAY.EXE. These are digitized sound files and not real music
  453.         files, so the space taken up on disk can be HUGE.
  454.  
  455.         Digitized sounds in other formats (Macintosh .SND, Sun .AU, Windows 
  456.         .WAV and many others) can be converted to .VOC using various 
  457.         utilities. I use and recommend SOX (maintained by Lance Norskog),
  458.         available at garbo.uwasa.fi in pc/sound.
  459.  
  460.     ┌────────────┐
  461.     │ .ZIP files │ All formats
  462.     └────────────┘
  463.         You need PKUNZIP.EXE (see section on .ZIP files below).
  464.  
  465.  
  466. All the song files have to reside in CD-Box's directory; the program files do
  467.   not have to, but make sure CD-Box has access to them (through a PATH 
  468.   statement for instance). CD-Box also examines the SOUND environnment 
  469.   variable and is able to load drivers and players from there if necessary.
  470.  
  471. To see if CD-Box detects properly your drivers and player programs, type
  472.   CD-BOX/D at the DOS prompt.
  473.  
  474.  
  475. ══════════════════════════════════════════════════════════════════════════════
  476. *** How do I tell CD-Box to support other drivers/players?
  477. ──────────────────────────────────────────────────────────────────────────────
  478.  
  479. If you have a player program that meets the following restrictions:
  480.  
  481.   - it can be run in "quiet" mode, i.e. no output of ANY kind while running,
  482.       no error messages, no nothing.
  483.  
  484.   - it does not switch to a specific video mode (for instance, text mode) when
  485.       run.
  486.  
  487.   then CD-Box can support it. Modify the CD-BOX.CFG configuration file using
  488.   any ASCII text editor to do this.
  489.  
  490.  
  491. ══════════════════════════════════════════════════════════════════════════════
  492. *** How do I add or remove songs to CD-Box?
  493. ──────────────────────────────────────────────────────────────────────────────
  494.  
  495. The song titles displayed in CD-Box depend entirely on the music files in the
  496.   current directory (either in .ZIP archives or not). If you want to add songs
  497.   to CD-Box, simply put them in the current directory. To remove them, delete
  498.   the files. In other words, CD-Box always reflects the current directory -
  499.   only the file names are replaced by song titles.
  500.  
  501. The above paragraph is modified by the fact that if you specify file 
  502.   specifications on the command line (for instance, CD-BOX *.ZIP NEW*.*), the 
  503.   song titles will be those found in the specified files only.
  504.  
  505.  
  506. ══════════════════════════════════════════════════════════════════════════════
  507. *** What's all this about .ZIP files?
  508. ──────────────────────────────────────────────────────────────────────────────
  509.  
  510. CD-Box is able to look into .ZIP files to see if there are any songs there; if
  511.   it finds any, the corresponding title will appear on the main screen, and
  512.   the song will be treated just as any other song. This means your songs can
  513.   be packed in .ZIP files in CD-Box's directory to save space; CD-Box will
  514.   find them anyway.
  515.  
  516.  
  517. *** When does CD-Box uncompress the songs stored in .ZIP files?
  518.  
  519. Unpacking occurs in two cases only:
  520.  
  521.   - at startup, if a song found in a .ZIP archive is not known to CD-Box, it
  522.       will exploded using PKUNZIP.EXE so that it can be analyzed. The program
  523.       will try to extract the most information from the file (title and length
  524.       in particular); the "Analyzing song" indicator is lit up. When done,
  525.       CD-Box will remove the unpacked file.
  526.  
  527.   - just before playing a song stored in a .ZIP archive, the ".ZIP" indicator
  528.       lights up and CD-Box invokes PKUNZIP.EXE to explode the song file, and
  529.       the bank file if necessary. When done playing, the unpacked files are
  530.       removed also.
  531.  
  532.  
  533. *** Where are files exploded to?
  534.  
  535. Files temporarily extracted from .ZIP files reside on:
  536.  
  537.   - the drive/directory specified by the Temp= statement in CD-BOX.CFG;
  538.  
  539.   - if Temp= is not specified, the drive/directory specified by the TEMP
  540.       environnment variable;
  541.  
  542.   - if TEMP doesn't exist, to the default drive/directory.
  543.  
  544. Always make sure there's enough room to hold the largest expanded song! 
  545.   Otherwise you'll get an "Unable to explode song" message.
  546.  
  547.  
  548. *** What program is necessary to take full advantage of this feature?
  549.  
  550. PKUNZIP.EXE from PKWare, Inc. If you don't have it, or if it is not reachable
  551.   through a PATH statement, and if you have .ZIP files in CD-Box's directory,
  552.   the message "Unable to explode song" will appear. CD-Box may also crash at
  553.   startup.
  554.  
  555. The bottom line: using .ZIP files with CD-Box is pretty easy and
  556.   straightforward. In the case of .MUS and .ROL music files, it also saves an
  557.   average of 80% of disk space!!! And if you .ZIP your music files by
  558.   category, you'll better take advantage of Files mode (described in part I).
  559.  
  560.  
  561. ══════════════════════════════════════════════════════════════════════════════
  562. *** Dual support? What's that?
  563. ──────────────────────────────────────────────────────────────────────────────
  564.  
  565. .CMF and .MOD files: it means CD-Box can play this format by itself. So you
  566.   have three choices:
  567.  
  568.   * The easiest: just let it play the songs and don't worry about anything
  569.       else.
  570.  
  571.   * If CD-Box won't play this format on your particular computer, you can try
  572.       overriding its routines by telling it to use an external player (ex:
  573.       AdLib users might have a .CMF player that works on their card). You
  574.       simply have to insert the appropriate statements in CD-BOX.CFG.
  575.  
  576.   * CD-Box can also use both: try playing the format by itself, and if that
  577.       fails, use an external player; you have to insert whatever is needed to
  578.       run the player in CD-BOX.CFG, and add a "Dual=yes" statement (ex: CD-Box
  579.       may not be able to play all your .MOD files, so you might want to use an
  580.       external player for the ones it cannot play. See .MOD files in part IV,
  581.       trouble-shooting).
  582.  
  583.  
  584. ══════════════════════════════════════════════════════════════════════════════
  585. *** Is there any way I can skip the animation?
  586. ──────────────────────────────────────────────────────────────────────────────
  587.  
  588. Indeed there is. Type CD-BOX/F at the DOS prompt.
  589.  
  590. You can also skip the title screen, but still have the animation, by pressing
  591.   a key while CD-Box is loading (before it switches to graphics mode).
  592.  
  593.  
  594. ══════════════════════════════════════════════════════════════════════════════
  595. *** Are there any shortcuts to make things happen more quickly?
  596. ──────────────────────────────────────────────────────────────────────────────
  597.  
  598. Try clicking the RIGHT mouse button. For instance, clicking the right mouse
  599.   button on a song button plays the song immediately, or clicking the right
  600.   mouse button on the "Rewind" and "Forward" buttons go to the beginning and
  601.   end of the song index, respectively. But if that's still too slow for you,
  602.   the /F parameter is even faster, but then you'll skip ALL the animations.
  603.  
  604. Right clicking is of course not available from the keyboard.
  605.  
  606.  
  607. ══════════════════════════════════════════════════════════════════════════════
  608. *** What does that "XXX duplicate!" message at startup mean?
  609. ──────────────────────────────────────────────────────────────────────────────
  610.  
  611. This can only happen if you use .ZIP files; it means you have two or more
  612.   files which have exactly the same filename in the CD-Box directory. CD-Box
  613.   ignores all duplicate filenames and remembers only the first one found. It's
  614.   not an error, it's a warning, but it can be annoying.
  615.  
  616. You have the same file twice in the directory (one in a .ZIP file, another in
  617.   a .ZIP file or simply in the directory). So delete one or rename the other.
  618.  
  619.  
  620. ══════════════════════════════════════════════════════════════════════════════
  621. *** How does CD-Box remember the title and length of songs?
  622. ──────────────────────────────────────────────────────────────────────────────
  623.  
  624. Files found in the current directory are the ones loaded, and the bank file
  625.   and title given depend on the following criteria:
  626.  
  627.   - If there is a SONGS.DAT file in the directory, and if it contains that
  628.       song, CD-Box loads the data from it (SONGS.DAT is an external database
  629.       CD-Box uses to remember songs).
  630.  
  631.   - Otherwise, if CD-Box knows that song intrisically (there is another
  632.       database directly programmed into CD-BOX.RSR), the data is read from
  633.       there.
  634.  
  635.   - If all this fails, then CD-Box tries to make the best possible guesses:
  636.  
  637.       + bank file: usually BNK974.BNK, or filename.SND, or none.
  638.  
  639.       + song title: extracted from disk (.CMF and .MOD), otherwise same as
  640.           filename.
  641.  
  642.       + length: 0 (unknown), except for .ROL files, where the length is
  643.           computed directly from the file on disk.
  644.  
  645. All this is recorded in CD-Box's external database (SONGS.DAT); if the
  646.   database doesn't exist, it is created. Any changes you make, and of course
  647.   the changes in length as computed when playing the song, take over the
  648.   default values, and are recorded as well.
  649.  
  650. All changes are actually written to disk when you quit CD-Box (Eject).
  651.  
  652. At the time of this writing, CD-Box intrinsically knows about 150 songs, but
  653.   this number keeps changing. Type CD-BOX/I at the DOS prompt to know exactly
  654.   how many.
  655.  
  656.  
  657. ══════════════════════════════════════════════════════════════════════════════
  658. *** How can I tell CD-Box to load only the song files my system supports?
  659. ──────────────────────────────────────────────────────────────────────────────
  660.  
  661. If you're missing some drivers or player programs, you might want CD-Box to
  662.   load only the files it can play, instead of loading them all and issuing an
  663.   error message each time. Give it the /L parameter at startup (CD-BOX /L).
  664.   Note that in this case CD-Box will also ignore songs in .ZIP archives if
  665.   PKUNZIP.EXE cannot be found.
  666.  
  667. Unplayable songs (i.e. missing driver or player) are grayed when you select
  668.   them in CD-Box.
  669.  
  670.  
  671. ══════════════════════════════════════════════════════════════════════════════
  672. *** What are the command line parameters?
  673. ──────────────────────────────────────────────────────────────────────────────
  674.  
  675. CD-BOX/? gives you a quick summary. Otherwise, here are the details:
  676.  
  677.  
  678.   * filespec: instead of scanning the entire directory, CD-Box will scan only
  679.         the files matching your file specifications. For instance, if you want
  680.         CD-Box to load the .MUS and .ROL files only, type CD-BOX *.MUS *.ROL;
  681.         or if you just got a brand new archive containing new songs called
  682.         ALLNEW.ZIP, and you want CD-Box to scan only that archive, type CD-BOX
  683.         ALLNEW.ZIP. An alternative is to use Files mode (see above). The
  684.         default for filespec is, of course, *.*.
  685.  
  686.  
  687.   * /D: This is a debugging tool which displays:
  688.  
  689.           - whether your copy of CD-Box is registered, and to whom;
  690.  
  691.           - whether any errors were found in CD-BOX.CFG;
  692.  
  693.           - the complete paths to all the drivers and players specified in
  694.               CD-BOX.CFG, if found;
  695.  
  696.           - the name of each file as it is read and analyzed from the 
  697.               directory when CD-Box starts up. I put this because CD-Box 
  698.               almost never checks whether a music file is valid or not before 
  699.               analyzing it (to speed things up). So, if you try to run CD-Box
  700.               and you get a "CRASH!", try using /D, and chances are you'll
  701.               spot the file which is invalid.  REMOVE THIS FILE FROM THE
  702.               DIRECTORY!
  703.  
  704.             There are a few checking routines to prevent this, however, so you
  705.               might get an "Invalid .ROL file" message or equivalent. In that
  706.               case, remove the file too.
  707.  
  708.             Duplicate songs are also displayed and reported.
  709.  
  710.  
  711.   * /F: All non-essential animation is skipped, including the title screen,
  712.         CDs popping up and down, buttons flipping over, .MOD level bars...
  713.         Use this parameter if CD-Box runs too slowly on your computer, or if
  714.         you're a little short on memory (you get thrown back to DOS with
  715.         messages like "Not enough memory to load..." or "VGA Sprite Manager
  716.         has run out of memory!").
  717.  
  718.         If you don't specify the /F parameter, you can still skip the title
  719.         screen by pressing a key while CD-Box is loading (before it switches
  720.         to graphics mode).
  721.  
  722.  
  723.   * /I: Displays how much memory CD-Box detects and reserves for animation
  724.         purposes, and also how many songs are in the internal and external
  725.         databases.
  726.  
  727.  
  728.   * /L: Tells CD-Box NOT to load the song formats which cannot be played (i.e.
  729.         a driver is not loaded or missing or a player program is missing). In
  730.         other words, CD-Box does not load songs which corresponding pilot
  731.         light is grayed. This includes .ZIP files; they will not be scanned if
  732.         PKUNZIP.EXE cannot be found.
  733.  
  734.  
  735.   * /M: Tells CD-Box not to use a mouse, even if it is able to detect one. 
  736.         This will remove the warning that no mouse is detected if none is 
  737.         present, and also will enable you to use the keyboard without having 
  738.         your mouse wrecking havoc on the screen, if your mouse driver is one 
  739.         of those which CD-Box doesn't like.
  740.  
  741.  
  742.   * /P: Loads CD-Box, plays n minutes of music by switching to Random mode,
  743.         and then exits back to DOS upon completion of the last song. If Esc is
  744.         pressed between songs, playback interrupts just as usual, and normal
  745.         operation is resumed: you can then use the mouse to choose songs,
  746.         change titles...
  747.  
  748.  
  749.   * /R: Removes the files specified on the command line from the external
  750.         database (SONGS.DAT). You have to specify the filenames (wildcards
  751.         accepted), not the song titles. For instance, to remove the files
  752.         IMPACT7.MOD and all Z*.ROL from SONGS.DAT, you would type CD-BOX /R
  753.         IMPACT7.MOD Z*.ROL. CD-BOX /R * would delete all the songs in
  754.         SONGS.DAT - it's easier to erase the file. You shouldn't ever need to
  755.         use /R, except in extremely rare cases where CD-Box would have fouled
  756.         up and recorded a song length of 456324875 hours for a specific
  757.         song...
  758.  
  759.  
  760.   * /V: Displays the contents (filename, bank filename, title and length) of 
  761.         the external database (SONGS.DAT) on the screen, pausing when the 
  762.         screen is full. The songs displayed match the file specifications on 
  763.         the command line - default is * (all). Blank entries in the Bank 
  764.         column indicate the file does not need any bank file (.CMF, .MOD and 
  765.         .VOC), and blank entries in the Length column indicate the length of 
  766.         the song is not known (0). If you want to save this listing to a file,
  767.         specify a filename, like this:
  768.  
  769.                                CD-BOX /V=filename
  770.  
  771.         Output will be saved to the file filename.TXT.
  772.  
  773.  
  774. ══════════════════════════════════════════════════════════════════════════════
  775. *** I have an AdLib card, is there a way I can play .CMF/.MOD/.VOC files?
  776. ──────────────────────────────────────────────────────────────────────────────
  777.  
  778. Yes... if you have a player which can do that. CD-Box can't. If you have FTP 
  779.   or News access, ask around, I've heard of an AdLib .CMF player, and of 
  780.   something to make the AdLib play .MODs. Whether they exist, and can be made 
  781.   to run with CD-Box (using CD-BOX.CFG) is another matter.
  782.  
  783.  
  784. ══════════════════════════════════════════════════════════════════════════════
  785. *** Is there anything else I should know about CD-Box?
  786. ──────────────────────────────────────────────────────────────────────────────
  787.  
  788. Well... there is. There are random animations happening at irregular
  789.   intervals. If you don't use the /F parameter and are patient, you should see
  790.   some from time to time.
  791.  
  792.  
  793. ══════════════════════════════════════════════════════════════════════════════
  794.  
  795.                          PART III: KEYBOARD SUPPORT
  796.  
  797. ══════════════════════════════════════════════════════════════════════════════
  798.  
  799. CD-Box can be used without the mouse entirely, although it was intended from 
  800.   the start to run with a mouse. In fact, versions up to v2.10 (inclusive) 
  801.   required a mouse; it was not optional. I added keyboard support since
  802.   somehow I have not been able to have routines that support ALL Microsoft
  803.   compatible mouse drivers out there (the vast majority work but not all).
  804.  
  805. Some random animations lose much of their interest without a mouse; sometimes
  806.   a gray arrow will appear to simulate the mouse, as in the lighter animation.
  807.  
  808. The keyboard is active even with a mouse. What CD-Box does when a key is
  809.   pressed is find which button to activate, then simulate a left button click.
  810.  
  811. Most buttons can be clicked on by pressing their first letter, the notable 
  812.   exceptions being Rewind and Forward, which are PgUp and PgDn, respectively.  
  813.   The long rectangular button under the main button menu work the same, but 
  814.   with the Alt key held down. The control buttons for .MOD files work with the
  815.   Ctrl key held down.
  816.  
  817. The exact keys to click on the various buttons are:
  818.  
  819. * SELECT MODE: Play: P             Rewind: PgUp        Forward: PgDn
  820.                Loop: L             Random: R           Eject: E
  821.  
  822. * PLAY MODE:   Stop: Esc           Skip: S             Pause/Resume: P
  823.                Rem: R              Total:  T
  824.                .MOD FILES ONLY: volume control: Ctrl A (min) to Ctrl L (max)
  825.                                 skip backward: Ctrl-left
  826.                                 skip forward: Ctrl-right
  827.  
  828. * MODIFY MODE: About: A            Rewind: PgUp        Forward: PgDn
  829.                File: F             Bank: B             Title: T
  830.  
  831. * FILES MODE:  Rewind: PgUp        Forward: PgDn       Rescan: R
  832.  
  833. Song buttons:  1 to 8 (1 to 4 in the first column, 5 to 8 in the second)
  834.  
  835. Mode buttons:  Files: Alt F        Goto: Alt G
  836.                Modify: Alt M       Unselect: Alt U
  837.  
  838. Esc will stop the song being played back, even if Play mode is not active and
  839.   the Stop button is not on displayed.
  840.  
  841.  
  842. ══════════════════════════════════════════════════════════════════════════════
  843.  
  844.                          PART IV: TROUBLE-SHOOTING
  845.  
  846. ══════════════════════════════════════════════════════════════════════════════
  847.                         CRASHES DURING SONG ANALYSIS
  848. ══════════════════════════════════════════════════════════════════════════════
  849. *** I get a "PKUNZIP either not found or crashed..." error message
  850. ──────────────────────────────────────────────────────────────────────────────
  851.  
  852. Run CD-BOX/D. If PKUNZIP.EXE is found, then CD-Box will say so... and crash 
  853.   while analyzing files stored in a .ZIP archive. Try unZIPping this archive 
  854.   by hand, and see what happens. The problem may be that the temporary drive 
  855.   or directory (Temp= in CD-BOX.CFG, or TEMP in your environnment) is invalid 
  856.   or full.
  857.  
  858. If PKUNZIP.EXE is not found, then you have a song in a .ZIP archive that
  859.   CD-Box tried to explode, but couldn't. CD-Box can read .ZIP files by itself,
  860.   but cannot extract files. So either make PKUNZIP.EXE available through the
  861.   path, or delete the .ZIP archive.
  862.  
  863. Another solution is to tell CD-Box not to load songs from .ZIP files if
  864.   PKUNZIP.EXE is not available; in that case, start CD-Box with the /L
  865.   parameter.
  866.  
  867.  
  868. ══════════════════════════════════════════════════════════════════════════════
  869. *** I get a "CRASH!" message while CD-Box analyzes a song
  870. ──────────────────────────────────────────────────────────────────────────────
  871.  
  872. Type CD-BOX/D to find the file that makes CD-Box crash. Then:
  873.  
  874.   * If it's while analyzing an uncompressed song, it means the song has an
  875.       invalid format, and CD-Box crashes when trying to extract meaningful
  876.       values like song title and song length. Delete that song file!
  877.  
  878.   * If it's while analyzing a .ZIP archive, it means the .ZIP is either empty
  879.       or is corrupted. Put something in it, fix it or get rid of it!
  880.  
  881.  
  882. ══════════════════════════════════════════════════════════════════════════════
  883.                       REFUSAL TO PLAY CERTAIN SONGS
  884. ══════════════════════════════════════════════════════════════════════════════
  885. *** CD-Box displays a "Driver not found" message!
  886. ──────────────────────────────────────────────────────────────────────────────
  887.  
  888. .CMF:
  889.  
  890. You're trying to play a .CMF file but haven't loaded the SBFMDRV driver before
  891.   starting CD-Box. Having SBFMDRV.COM on disk is not enough, it has to be
  892.   loaded too (you can always unload it afterwards by typing SBFMDRV/U).
  893.  
  894. Others:
  895.  
  896. The driver specified in the CD-BOX.CFG file could not be found. Either the
  897.   driver is not on the PATH or SOUND environnment variable, or the driver name
  898.   is mispelled in the CD-BOX.CFG file. Typing CD-BOX/D at the DOS prompt may
  899.   help.
  900.  
  901.  
  902. ══════════════════════════════════════════════════════════════════════════════
  903. *** CD-Box displays a "Player program not found" message!
  904. ──────────────────────────────────────────────────────────────────────────────
  905.  
  906. You have tried playing a song, and the associated player program was not found
  907.   (the pilot light at the top should be grayed). Make note of the format
  908.   causing problems, then run CD-Box with the /D parameter. If the
  909.   corresponding program is displayed as "not found.", then you can't play
  910.   these songs, unless:
  911.  
  912.   * You get the program and put it in CD-Box's directory, the directory from
  913.       the SOUND environnment variable, or somewhere on your PATH.
  914.  
  915.   * Or you modify the CD-BOX.CFG file to have CD-Box support another player
  916.       you might have for that format. See CD-BOX.CFG for details.
  917.  
  918.  
  919. ══════════════════════════════════════════════════════════════════════════════
  920. *** CD-Box displays a "Don't know how to play" message!
  921. ──────────────────────────────────────────────────────────────────────────────
  922.  
  923. There's something wrong in the CD-BOX.CFG file. Either the player= or
  924.   parameters= command is missing, and both must be present.
  925.  
  926. .CMF: since CD-Box supports this format internally, you can also remove the
  927.   [CMF] section in CD-BOX.CFG (if there is one). This way, CD-Box won't try to
  928.   look for external drivers and/or players, and will use its own code to play
  929.   the songs.
  930.  
  931. .MOD: same as above
  932.  
  933.  
  934. ══════════════════════════════════════════════════════════════════════════════
  935. *** CD-Box doesn't play the song, and there is no error message!
  936. ──────────────────────────────────────────────────────────────────────────────
  937.  
  938. If CD-Box acts as if it will play a song, but in fact doesn't play it at all, 
  939.   and no error is generated, it may be because the song needs more memory to 
  940.   play - often the case with .MOD files above 250 KB, or with certain complex 
  941.   .ROL files. I'm working on ways to decrease the (huge) memory requirements
  942.   of CD-Box, but I can't do much better than the current version. Freeing DOS
  943.   memory and loading drivers high is definitely a bonus.
  944.  
  945. Another possibility is that the player got an error (usually out of memory,
  946.   but it could be corrupted bank file or something else), but reported none.
  947.   CD-Box is then fooled into thinking everything was okay. Try playing the
  948.   song by hand under DOS (using full pathnames, if the song is exploded on a
  949.   different drive/directory), and see what happens.
  950.  
  951.  
  952. ══════════════════════════════════════════════════════════════════════════════
  953. *** CD-Box displays "Unable to explode song"!
  954. ──────────────────────────────────────────────────────────────────────────────
  955.  
  956. Three possibilities (at least :-):
  957.  
  958.   - CD-Box can't find PKUNZIP.EXE. Either make it available to CD-Box, remove
  959.       any .ZIP files containing songs you may have in CD-Box's directory, or
  960.       run CD-Box with the /L parameter.
  961.  
  962.   - There isn't enough room on the temporary drive.
  963.  
  964.   - .MUS and .ROL only: there is a second possibility: CD-Box has not found
  965.       the bank file or could not explode it. Try changing the name of the bank
  966.       file associated to the song, or if the name is okay, check that it is in
  967.       the same .ZIP archive than the song.
  968.  
  969.  
  970. ══════════════════════════════════════════════════════════════════════════════
  971.                          TROUBLE WITH .MOD FILES
  972. ══════════════════════════════════════════════════════════════════════════════
  973. *** CD-Box displays "Error loading .MOD"!
  974. ──────────────────────────────────────────────────────────────────────────────
  975.  
  976. CD-Box recognizes only 31-instrument .MOD files; you may have .MODs it won't
  977.   play even though players like ModPlay do. There are two solutions to this:
  978.  
  979.   * Use an external player to play .MOD files, either overriding completely
  980.       CD-Box's routines or using dual support (giving CD-Box a chance to play
  981.       the song and telling it to use the external player if it can't)
  982.  
  983.   * If you have ModEdit (or maybe another .MOD editor), load and save the .MOD
  984.       files. ModEdit will always save the song as a 31-instrument .MOD, so it
  985.       will be playable by CD-Box (it works all the time for me). I have a
  986.       batch file that does this automatically as soon as I get new .MODs...
  987.  
  988.  
  989. ══════════════════════════════════════════════════════════════════════════════
  990. *** .MOD files sound terrible!
  991. ──────────────────────────────────────────────────────────────────────────────
  992.  
  993. Apart from using an external player, you can try changing the "MixingSpeed="
  994.   statement in CD-BOX.CFG. The higher the value, the better, but CD-Box's
  995.   feedback will slow down accordingly while playing .MOD files and might even
  996.   hang if you specify a value that is too high for your computer. The default
  997.   is 10000 Hz, 15909 Hz gives good results on computers fast enough.
  998.  
  999.  
  1000. ══════════════════════════════════════════════════════════════════════════════
  1001. *** Clicking on "Pause" while playback doesn't really pause!
  1002. ──────────────────────────────────────────────────────────────────────────────
  1003.  
  1004. Well, YOU try pausing a .MOD file without killing it completely. Great fun.
  1005.   No, seriously, if pausing doesn't work, just resume and try pausing again -
  1006.   it works when they aren't too many instruments around. CD-Box has the same
  1007.   pausing problems as ModPlay... no wonder, I use almost the same routines!
  1008.  
  1009.  
  1010. ══════════════════════════════════════════════════════════════════════════════
  1011.                            HARDWARE TROUBLE
  1012. ══════════════════════════════════════════════════════════════════════════════
  1013. *** I get a "VGA Sprite Manager has run out of memory" message!
  1014. ──────────────────────────────────────────────────────────────────────────────
  1015.  
  1016. The VGA Sprite Manager is a huge object responsible for animating sprites on
  1017.   the VGA screen, not messing up the background, being able to superpose
  1018.   different sprites on different planes, and preventing flicker. However, it 
  1019.   also needs a LOT of memory; 64 KB + the sprites to move, so it usually 
  1020.   amounts to about 80 - 90 KB. So either free more memory before running 
  1021.   CD-Box, or use the /F parameter. The animations will be skipped, and the 
  1022.   Sprite Manager will not be invoked. But chances are you're too short on 
  1023.   memory to play songs anyway.
  1024.  
  1025.  
  1026. ══════════════════════════════════════════════════════════════════════════════
  1027. *** CD-Box returns suddenly to DOS and I get a "CRASH!" message!
  1028. ──────────────────────────────────────────────────────────────────────────────
  1029.  
  1030. Well, you stumbled on a bug. I left all the checking routines on in CD-Box's
  1031.   code, so that instead of hanging up and forcing you to reboot, it exits to
  1032.   DOS (in most cases).
  1033.  
  1034. Restart CD-Box and try not to do it again - if you use CD-Box normally, you 
  1035.   shouldn't get any bug. It's when you try to insist (for example, a .MOD song
  1036.   might not play because of insufficient memory, so don't try clicking on the
  1037.   song button 10 times to try to play it anyway), that CD-Box crashes. I, of
  1038.   course, am trying to get the number of bugs to an absolute minimum (very
  1039.   close to zero).
  1040.  
  1041.  
  1042. ══════════════════════════════════════════════════════════════════════════════
  1043. *** I get "Not enough memory to..." messages and CD-Box returns to DOS!
  1044. ──────────────────────────────────────────────────────────────────────────────
  1045.  
  1046. You have a fatal memory overflow. You have to free more memory; run CD-Box by
  1047.   itself under DOS, not as a shell from another program. You can also try
  1048.   typing CD-BOX /F at the DOS prompt, and if you can get to the main screen,
  1049.   you may be safe... but you may also be too short on memory to play songs
  1050.   anyway.
  1051.  
  1052.  
  1053. ══════════════════════════════════════════════════════════════════════════════
  1054. *** I have a SoundBlaster but am not able to play any songs!
  1055. ──────────────────────────────────────────────────────────────────────────────
  1056.  
  1057. I have a SoundBlaster v1.50 so I'm sure CD-Box runs with this card. Above
  1058.   versions should work, as well as any SoundBlaster compatible card - it runs
  1059.   on the AdLib (except for .CMF and .MOD of course), and net users of CD-Box
  1060.   v2.01 report that it works with the SoundBlaster Pro. However, a net user 
  1061.   reported that it didn't work with his SoundBlaster v1.05. Maybe the use of 
  1062.   CD-BOX.CFG can solve this problem, but nothing is guaranteed - I have no way 
  1063.   to test that.
  1064.  
  1065.  
  1066. ══════════════════════════════════════════════════════════════════════════════
  1067. *** I have trouble with my mouse!
  1068. ──────────────────────────────────────────────────────────────────────────────
  1069.  
  1070. YOU SHOULDN'T. Previous versions of CD-Box did have problem with furry 
  1071.   creatures, but this version should NOT any more. CD-Box assumes the mouse is 
  1072.   100% Microsoft compatible (200% compatibility or more preferred). Some 
  1073.   workarounds are changing the driver, or even changing the clock speed (turbo
  1074.   or non-turbo speed - weird, huh?).
  1075.  
  1076. If CD-Box definitely cannot swallow your driver, use the keyboard (see part 
  1077.   III). Use the /M parameter to remove mouse support entirely and not have the
  1078.   mouse pointer wreck the screen.
  1079.  
  1080.  
  1081. ══════════════════════════════════════════════════════════════════════════════
  1082. *** That darn program doesn't work AT ALL!
  1083. ──────────────────────────────────────────────────────────────────────────────
  1084.  
  1085. Read the license (part VI) if you haven't already done so.
  1086.  
  1087. I CANNOT GUARANTEE THAT CD-BOX WILL RUN ON YOUR PARTICULAR COMPUTER.
  1088.  
  1089. Let's be reasonable: I cannot guarantee that this program will work for you.
  1090.   You MUST have a VGA display, a Microsoft compatible mouse, and a lot of free
  1091.   RAM (at least 500 KB, 550 KB better; if you don't have 640K conventional
  1092.   memory, forget it - but then who doesn't these days?). This is the very
  1093.   minimum configuration under which CD-Box will run. If you want to hear the
  1094.   songs, you need an AdLib Music Synthetizer Card or a SoundBlaster card
  1095.   (CD-Box does run, but is of absolutely no use without a music card). And if
  1096.   you have a lot of songs, you need (a little) more memory, too, of course. I
  1097.   have only tested in on 286s so far, and net users didn't report any problems
  1098.   with their 386s and 486s; a 8086 might be slow, though. If you have a 8086,
  1099.   you should try the /F parameter.
  1100.  
  1101. As far as I know, this program is free of bugs (except for those mentioned
  1102.   above). If you find any, TELL ME in detail! There's no chance of the bug
  1103.   being corrected if I don't know about it!
  1104.  
  1105. When reporting a bug, please be as precise as possible. What version number of 
  1106.   CD-Box are you using? What exactly were you doing when the bug happened?  
  1107.   What are the exact symptoms? I received in the past bug reports about mice 
  1108.   for CD-Box v2.02 and below, like "my mouse goes crazy" or "doesn't work"...  
  1109.   how am I supposed to work on this?!? It was by asking for details that I 
  1110.   finally knew that "the yellow mouse seems to be at double the position of 
  1111.   the white mouse", and that "random colored points are sprayed around the
  1112.   mouse arrow", and so the trouble was fixed - at least on the machines
  1113.   tested, hopefully on all.
  1114.  
  1115.  
  1116. ══════════════════════════════════════════════════════════════════════════════
  1117.  
  1118.                            PART V: EPILOGUE
  1119.  
  1120. ══════════════════════════════════════════════════════════════════════════════
  1121. Version history
  1122. ──────────────────────────────────────────────────────────────────────────────
  1123.  
  1124.   * v1.00: CD-Box is born
  1125.  
  1126.   * v1.10: Screen packing/unpacking routines shrink the resource file
  1127.  
  1128.   * v1.11: Right mouse button support, /? and /F command-line switches.
  1129.  
  1130.   * v1.20: Increased animation (5 digit display, CD spins)
  1131.  
  1132.   * v1.50: (Major rewrite) Introduction of the expert database (no data file
  1133.           needed), new button set to make changes within CD-Box, scrolling
  1134.           display, /I command line parameter added.
  1135.  
  1136.   * v1.51: Internal programming upgraded with objects!
  1137.  
  1138.   * v1.60: CD-Box keeps growing:
  1139.  
  1140.     - Support for .CMF and .VOC files; increased support for .ROL files, by
  1141.         being able to compute the playing time from the file on disk.
  1142.  
  1143.     - /V parameter added, so you can look into SONGS.DAT, and /P parameter
  1144.         added. At the same time, the internal database has been updated and
  1145.         expanded to 98 songs.
  1146.  
  1147.     - Addition of "Goto" mode, and "cleaning up" of the various buttons,
  1148.         dividing them into three distinct modes with different color themes.
  1149.  
  1150.     - The scrolling display scrolls up instead of left, and the messages stay
  1151.         a while on-screen - makes it much easier to read messages, which is
  1152.         all that display was about in the first place!
  1153.  
  1154.   * v1.61: "Bug" fix:
  1155.  
  1156.     - CD-Box starts checking for some cases of invalid .ROL formats, which
  1157.         made the program crash at startup while analyzing the file. Also, the
  1158.         /D has been added, so you can see which file causes the error, and
  1159.         remove it.
  1160.  
  1161.     - A most subtle bug causing black lines to sometimes appear on the song
  1162.         buttons has been tracked down and DESTROYED.
  1163.  
  1164.     - CD-Box's capacity extended to about 300 songs (I haven't tried more).
  1165.  
  1166.   * v2.00: CD-Box gets better, thanks to the network! (see thanks below)
  1167.  
  1168.     - Support for .MOD files, thanks to Mark J Cox's "quiet" player ModPlay.
  1169.         The drawback: I had to reorganize CD-Box's allocation routines so that
  1170.         they leave enough memory for ModPlay to load large songs (if you have
  1171.         about 570 KB free before you run CD-Box, a 210 KB .MOD file is about
  1172.         the maximum CD-Box can load) - so now CD-Box is again split in two
  1173.         files, CD-BOX.EXE and CD-BOX.RSR. It's no big deal, but...
  1174.  
  1175.     - INTERNAL SUPPORT FOR .CMF files has been added; now the digits display a
  1176.         real-time clock (time elapsed & time left & total time elapsed &
  1177.         left), and you can PAUSE and RESUME the song any time.
  1178.  
  1179.     - A percentage bar displaying time played/time left (which are recomputed
  1180.         at the end of each song if the length of the song just played proved
  1181.         to be longer than CD-Box thought it was) is added.
  1182.  
  1183.     - Some people felt frustrated not being able to move the mouse all over
  1184.         the screen. Okay! In this version, you are able to!
  1185.  
  1186.     - Still more songs added to CD-Box's internal database.
  1187.  
  1188.     - VGA screens updated and much prettier (thanks to advice on subtle light
  1189.         reflections), and random animations added!!!
  1190.  
  1191.   * v2.01: some little glitches fixed, others optimized (duplicates with same
  1192.       names but different extensions are now accepted as two distinct songs).
  1193.       Also, the first version to be released on wide-scale servers in the
  1194.       U.S.A. (SIMTEL and FTP sites supported by the Sound Newsletter).
  1195.  
  1196.   * v2.02: A few improvements & bug fixes
  1197.  
  1198.      - All (or most) 2-button cheese eaters should work well now.
  1199.  
  1200.      - About 30 or 40 KB more free for those huge .MOD files.
  1201.  
  1202.      - A little less runtime errors, and a little more explicit messages.
  1203.  
  1204.      - Sprites as well as screens are shrinked in the resource file, saving
  1205.          50 KB (out of 220)! Hurray!
  1206.  
  1207.      - Some new animations, find them yourself!
  1208.  
  1209.   * v2.10: Inspired by net feedback...
  1210.  
  1211.      - INTERNAL SUPPORT FOR .MOD files. This, added to the fact that about
  1212.          30 KB of memory have been freed (despite CD-Box's growing complexity
  1213.          - over 1 Megabyte of sources!), means that monsters like "Flip House"
  1214.          can be played!!!
  1215.  
  1216.      - CD-BOX.CFG file added for maximum flexibility - CD-Box can now support
  1217.          ANY player that can run in "quiet" mode. What's more, if the formats
  1218.          evolve, you can override CD-Box's internal routines with an external
  1219.          player that supports the evolved format. Also, two parameters (.MOD
  1220.          mixing speed and temporary drive redirection) can be controlled from
  1221.          the .CFG file.
  1222.  
  1223.      - The pilot lights across the top (.CMF .MOD etc) are completely off if
  1224.          the corresponding format cannot be played (missing driver or player),
  1225.          so you know whether this format works without having to try and play
  1226.          a song file; in the same vein, unplayable songs are grayed when you
  1227.          select them. Also, /L (and /R) parameters added.
  1228.  
  1229.      - Files... mode added (rather easily to my own surprise - long live OOP!)
  1230.  
  1231.      - A *lot* of other small improvements (including completely rewritten 
  1232.          mouse routines)...
  1233.  
  1234.   * v2.11: CD-Box (unfortunately?) changes status and becomes shareware.
  1235.  
  1236.      - keyboard support; CD-Box can run without a mouse altogether.
  1237.  
  1238.      - .MOD controls: volume control, moving within the song, and level bars; 
  1239.          also .MOD output redirection added in configuration file.
  1240.  
  1241.   * Other ideas:
  1242.  
  1243.     - MORE INTERNAL SUPPORT for music files, without having to shell to
  1244.         external programs.
  1245.  
  1246.     - Support for any viable format I'll come across (all I need is a quiet
  1247.         player, better yet routines to play the format...)
  1248.  
  1249.     - I might work on a Windows version but that's another story...
  1250.  
  1251.     - Any more (viable) suggestions?
  1252.  
  1253.  
  1254. ══════════════════════════════════════════════════════════════════════════════
  1255. How you can help with CD-Box
  1256. ──────────────────────────────────────────────────────────────────────────────
  1257.  
  1258. I'm interested in sources or linkable object files to play .MUS, .ROL or .VOC
  1259.   files, since they allow the mouse to stay in control, the animation to
  1260.   continue, and the timer and percent bar are then displayed as real-time...
  1261.   and of course the user does not have to bother about a player program. If
  1262.   you have Pascal or C sources, or Turbo C .OBJ files that you're willing to
  1263.   share (provided it is legal to do so, i.e. your work, freeware, public
  1264.   domain, complete shareware archive), then write me. If I work them in, I'll
  1265.   acknowledge that in the documentation and in CD-Box itself (the About
  1266.   button). .CMF and .MOD support were obtained in this way.
  1267.  
  1268. I hope I'll be able to go on supporting CD-Box. I'm currently doing my
  1269.   military service (obligatory in France), and free time so far with access to
  1270.   my computer has been very scarce - also I'm hampered by the fact I have no
  1271.   direct access to the net (this version has been sent to Dave Komatsu and he
  1272.   has been the one who uploaded it to the net). This is why your feedback via
  1273.   snail-mail is so important.
  1274.  
  1275.  
  1276. ══════════════════════════════════════════════════════════════════════════════
  1277. Thanks to...
  1278. ──────────────────────────────────────────────────────────────────────────────
  1279.  
  1280. CD-Box would not be the program it is without the help from the following
  1281.   people - thanks to the net!
  1282.  
  1283. - Anthony Rumble, for his sources in Pascal of .CMF & .VOC routines 
  1284.     (distributed as SBUTIL11.EXE). I have made my own librairies for .CMF now, 
  1285.     but the critical routines were all supplied by Anthony (his .VOC player 
  1286.     only works for files smaller than 64K, so I couldn't use it, but it's a 
  1287.     good start!). Thanks. Now all I need are .ROL routines that work...
  1288.  
  1289. - Mark J. Cox for his MODOBJ package which I happily registered, giving CD-Box 
  1290.     the opportunity to play great sounding Amiga soundtracks by itself, with a 
  1291.     few extra features thrown in (.MOD controls). Mark J Cox is also the
  1292.     author of ModPlay, a terrific freeware .MOD player which I highly
  1293.     recommend; if you don't have it, go GET IT! (The latest version should be
  1294.     at info.brad.uk, in /misc/msdos/mp.)
  1295.  
  1296. - Victor Langeveld for reporting two bugs in CD-Box v2.01 with enough detail
  1297.     to get them fixed in CD-Box v2.10; my heartest thanks. :-)
  1298.  
  1299. - Ed Haymore for prompting me to implement the temporary drive redirection,
  1300.     and for the main idea behind file selecting.
  1301.  
  1302. - Bjorn Karlsen for prompting for keyboard support and volume control.
  1303.  
  1304. - Dave Komatsu, editor of the Sound Newsletter, and Keith Petersen, maintainer
  1305.     of the MSDOS archives at SIMTEL, for having accepted my submission
  1306.     (starting with v2.01)! Also, more thanks to Dave for uploading this
  1307.     version as I currently am not on the net.
  1308.  
  1309. - Bruno Deltour for aesthetic remarks; Alain Rousseau for providing me many
  1310.     files from the net when I didn't have access to it; Jean-Francois Moufle
  1311.     for drawing the car (now much reduced) driving across the bottom of the
  1312.     screen at odd times (yes, I did draw all the other graphics, and no, I'm
  1313.     not an artist!); and various friends and relations for their stumbling on
  1314.     (thankfully rare) bugs, helpful comments and encouragement.
  1315.  
  1316. I hope you enjoy the song New Entertainer in the CDBOX211.ZIP archive - I
  1317.   programmed it myself! It is based, of course, on Scott Joplin's remarkable
  1318.   Entertainer (from the movie whose French title is "L'arnaque", and the
  1319.   English title I don't know), so the credit is his. Off Balance, on the 
  1320.   other hand, is entirely mine.
  1321.  
  1322.  
  1323. ══════════════════════════════════════════════════════════════════════════════
  1324.  
  1325.                     PART VI: LICENSE & ABSENCE OF WARRANTY
  1326.  
  1327. ══════════════════════════════════════════════════════════════════════════════
  1328.  
  1329. The word "software" below refers to the four files CD-BOX.EXE, CD-BOX.RSR,
  1330.   CD-BOX.DOC and CD-BOX.CFG.
  1331.  
  1332. You may copy this software as many times as you like, give it to anyone, and
  1333.   distribute it via electronic means. This software may also be distributed in
  1334.   shareware and/or public domain libraries that charge for copying and
  1335.   distributing disks, NOT for the software itself.
  1336.  
  1337. You may NOT charge or request a donation for a copy of this software, however
  1338.   made; and you may NOT distribute this program and/or documentation with
  1339.   commercial products without handwritten permission from the author.
  1340.  
  1341. THIS SOFTWARE MAY NOT BE GIVEN AWAY OR DISTRIBUTED WITHOUT ITS DOCUMENTATION;
  1342.   AND NEITHER PROGRAM NOR DOCUMENTATION MAY BE ALTERED IN ANY WAY.
  1343.  
  1344. CD-Box is delivered "AS IS" with no promise to its performance or fitness for
  1345.   a particular purpose. CD-BOX COMES WITH NO GUARANTEE OF ANY KIND, NOR IS THE
  1346.   AUTHOR LIABLE FOR DAMAGES OF ANY KIND. The person using this software
  1347.   assumes all the risks.
  1348.  
  1349. If you use this software, you must pay the registration fee.
  1350.  
  1351. The software and documentation are copyrighted (C) Jeffrey Belt 1992.
  1352. All trademarks and registered names are acknowledged.
  1353.  
  1354. Do NOT use CD-Box if you do not agree to this license.
  1355.  
  1356.  
  1357. ══════════════════════════════════════════════════════════════════════════════
  1358. The bottom line
  1359. ──────────────────────────────────────────────────────────────────────────────
  1360.  
  1361. CD-BOX IS SHAREWARE.
  1362. CD-BOX COMES WITH NO WARRANTY.
  1363. CD-BOX CANNOT BE USED FOR COMMERCIAL GAIN.
  1364. CD-BOX MUST BE DISTRIBUTED WITH THIS DOCUMENTATION.
  1365.  
  1366. The above is simply to make sure that:
  1367.  
  1368.   * You can copy and give CD-Box to anyone, and use it without any qualms,
  1369.       once you registered of course :-)
  1370.  
  1371.   * Distributing CD-Box won't make me any trouble - hey, I'm giving it away
  1372.       for peanuts!
  1373.  
  1374.   * This documentation stays with CD-Box; it contains acknowledgements and
  1375.       thanks to people who deserve it. Intellectual property is something many
  1376.       people don't seem to understand.
  1377.  
  1378.  
  1379. ══════════════════════════════════════════════════════════════════════════════
  1380.  
  1381.                         PART VII: REGISTERING CD-BOX
  1382.  
  1383.           CD-BOX IS SHAREWARE. THE REGISTRATION FEE IS A MINIMUM OF $10.
  1384.  
  1385. ══════════════════════════════════════════════════════════════════════════════
  1386. *** Rationale: why CD-Box has become shareware
  1387. ──────────────────────────────────────────────────────────────────────────────
  1388.  
  1389. CD-Box is no longer freeware - sorry. Believe me, making it shareware has been
  1390.   a difficult decision because I'm afraid it will slow down user feedback, and
  1391.   that's what I want most. My reasons for shareware are:
  1392.  
  1393.   - development costs mainly (more than $200 now): I had to register other
  1394.       shareware routines for use in CD-Box; looking for precise info on mice
  1395.       and the sound cards is not cheap in the long run; and neither was access
  1396.       to the net, which was vital for the development of CD-Box (upload and
  1397.       download). Also, since it looks like I'll have to buy a number of
  1398.       development kits, really big expenses are on the horizon.
  1399.  
  1400.   - maintaining this documentation is one big bore.
  1401.  
  1402.   - most of my time is spent trying to track down bugs for users with exotic
  1403.       configurations, and not for creative development which I like best.
  1404.       Improving CD-Box I do for free; working on funny mouse drivers, weird
  1405.       VGA cards and tricky sound formats I don't any more, thank you. CD-Box
  1406.       works perfectly on MY machine, so I want it to be worth the trouble to
  1407.       fix it for others.
  1408.  
  1409. This is why CD-Box has become shareware. You have no need to register up to
  1410.   CD-Box v2.10. However, starting with this version, you must. Registration
  1411.   will:
  1412.  
  1413.   - remove the "unregistered copy" messages and unlock the .MOD controls.
  1414.  
  1415.   - help me get even with the costs for continued development. I'm not doing
  1416.       this for money, but I want to stop throwing it away.
  1417.  
  1418.   - increase the priority of bug reports and suggestions for improvement over
  1419.       those of unregistered users.
  1420.  
  1421. All future versions of CD-Box will have at least all the functionalities of
  1422.   CD-Box v2.10; some extras will have to be registered (as with the .MOD
  1423.   controls in this version).
  1424.  
  1425. I'm very much aware that the .MOD controls are a simple extra, but then the 
  1426.   $10 are mostly symbolic. I don't want CD-Box to be nagware or crippleware,
  1427.   but I also know that people are more inclined to pay if they get a little
  1428.   something more. I hope I struck the right balance.
  1429.  
  1430.  
  1431. ══════════════════════════════════════════════════════════════════════════════
  1432. *** Registering CD-Box
  1433. ──────────────────────────────────────────────────────────────────────────────
  1434.  
  1435. CD-Box must be registered for a minimum fee of $10 ($8 raw fee + $1 my answer
  1436.   to you + $1 bank commission). If you send $15 or more, I'll also send you
  1437.   the next version of CD-Box when available. If the next version is slow in
  1438.   coming, I'll refund the money if you want to, minus $10 since you'll already
  1439.   have a registration number.
  1440.  
  1441. Registrating CD-Box will remove the "unregistered copy" message at startup and
  1442.   unlock the .MOD controls.
  1443.  
  1444. US dollars are used for convenience; ANY currency will do, as long as it
  1445.   amounts to the sums given above; take bank commission into account. French
  1446.   users don't have to pay a bank commission, since French Francs is the money
  1447.   I use: the French registration fee is 50 Francs; 70 Francs or more to have
  1448.   the next version mailed when available.
  1449.  
  1450. Some people who have helped me in the past pointing out bugs and giving useful
  1451.   suggestions (and you know who you are) simply have to write me to get their
  1452.   registration number (that includes all the people I thanked in the "Thanks
  1453.   to..." section above). I'm grateful for the help they gave me.
  1454.  
  1455. To register, send a check or money order (no cash nor VISA accepted) to:
  1456.  
  1457.                          Jeffrey BELT
  1458.                          7 rue de la Garenne
  1459.                          77240 - CESSON
  1460.                          FRANCE
  1461.  
  1462. Checks have to be to the order of Jeffrey Belt.
  1463.  
  1464. Include a paper stating:
  1465.  
  1466.   - YOUR FULL NAME (extremely important for the registration number) and the
  1467.       address where the registration instructions should be mailed;
  1468.  
  1469.   - where you got CD-Box (which server, list, BBS, shareware distribution
  1470.       company...), and which version you have (this one is v2.11);
  1471.  
  1472.   - any comments or suggestions you wish to make.
  1473.  
  1474. In return I'll send you a registration number and tell you how to unlock
  1475.   CD-Box.
  1476.  
  1477. If you send $15 or more, please state if you want the next version sent on
  1478.   another disk than a 3'1/2 720 KB disk. Don't expect to receive immediately
  1479.   the next version, it may not be ready yet (I've got to program and test this
  1480.   stuff!), but it will be sent to you as soon as it is ready.
  1481.  
  1482.  
  1483. ══════════════════════════════════════════════════════════════════════════════
  1484. *** Comments or suggestions?
  1485. ──────────────────────────────────────────────────────────────────────────────
  1486.  
  1487. To my greatest sorrow I currently have no access to the net, until further
  1488.   notice. I therefore have no e-mail address (the old one belt@aar... will no
  1489.   longer work). But snail mail works, so don't hesitate to write! It's the
  1490.   only way I can get feedback to continue work on this program.
  1491.  
  1492. ******************************************************************************
  1493. ***                                                                        ***
  1494. *** I really insist on user feedback. It's been the driving force behind   ***
  1495. *** CD-Box's improvements since it was launched on the net. Now that I'm   ***
  1496. *** no longer on the net, feedback is much more important - and has been   ***
  1497. *** much more scarce; I know snail-mail is more trouble than e-mail, but   ***
  1498. *** still! A simple postcard is enough. And if you wish to write me for    ***
  1499. *** comments or suggestions, you are most WELCOME!                         ***
  1500. ***                                                                        ***
  1501. ***                                                                        ***
  1502. ***                     Jeffrey Belt                                       ***
  1503. ***                     7 rue de la Garenne                                ***
  1504. ***                     77240 - CESSON                                     ***
  1505. ***                     FRANCE                                             ***
  1506. ***                                                                        ***
  1507. ******************************************************************************
  1508.